
 ComPortLib 4.20 控件在 Embarcadero RAD Studio 12.3 中的安装说明

 一、序言
 
 ComPortLib 控件源代码是Delphi,  测试支持 Embarcadero RAD Stduio 12.3。
 
 选择 Install_for_CB_XE12_ProjectGroup1.groupproj，控件安装在 Embarcadero C++Builder 12.3 IDE。


 二、  ComPortLib 4.20 控件 for Embarcadero C++Builder 12.3 安装步骤

 1. 以管理员身份运行RAD Stduio 12.3，打开工程组 Install_for_CB_XE12_ProjectGroup1。

 2. 右键单击 Install_for_CB_XE12_ProjectGroup1, 执行Build All。

    在32-bit程序中需要x86版本控件，可以选择x86 release 模式，执行Build ALL。
    在64-bit程序中需要x64版本控件，可以选择x64 release 模式，执行Build ALL。

 3. 右键单击 DsgnCPortCB12.bpl, 在弹出菜单中执行Install/Unistall。
    如果启动的是32-bit IDE，需要选择x86 release 模式，执行Build ALL，再点击安装。

 三、 ComPortLib 4.20 控件  for Embarcadero C++Builder 12.3 编译设置修改

 Delphi Compiler \ Output-C/C++\All configurations - All platforms 设置

 1.  hpp文件输出路径，本控件设置为 $(BDSCOMMONDIR)\hpp\$(Platform)
     即 C:\Users\Public\Documents\Embarcadero\Studio\23.0\hpp\Win32
     或 C:\Users\Public\Documents\Embarcadero\Studio\23.0\hpp\Win64

     之前的路径带有$(Config)，RAD Stduio 12.2\12.3不支持下一级路径，只能移除$(Config)。

 2.  bpi文件输出路径，本控件设置为 $(BDSCOMMONDIR)\DCP\$(Platform)\$(Config)
     即 C:\Users\Public\Documents\Embarcadero\Studio\23.0\Dcp\Win32\Release
     或 C:\Users\Public\Documents\Embarcadero\Studio\23.0\Dcp\Win64\Release

 3.  .obj/.lib 输出路径，本控件设置为 $(BDSCOMMONDIR)\DCP\$(Platform)\$(Config)
     即 C:\Users\Public\Documents\Embarcadero\Studio\23.0\Dcp\Win32\Release
     或 C:\Users\Public\Documents\Embarcadero\Studio\23.0\Dcp\Win64\Release

 C++ Shared Options 设置
 1. BPI/LIB output               :    $(BDSCOMMONDIR)\BPL\$(Platform)\$(Config)
 2. Final output directory    :    $(BDSCOMMONDIR)\BPL\$(Platform)\$(Config)
 3. Intermediate output      :    $(BDSCOMMONDIR)\BPL\$(Platform)\$(Config)

 四、Embarcadero C++Builder 12.3 应用程序注意事项：

 1.  C++ Shared Options \All configurations - All platforms \ Include path 选项
     增加路径 $(BDSCOMMONDIR)\hpp\$(Platform)
     可解决找不到 hpp文件的问题。
     
 2.  C++ Shared Options \All configurations - All platforms \ Library path 选项
     增加路径 $(BDSCOMMONDIR)\BPL\$(Platform)\$(Config)
     可解决找不到  BPI 文件的问题。 

 3.  C++ Shared Options \All configurations - All platforms \ Library path 选项
     链接时 找不到 *.dfm *.res 文件，增加路径:

     C:\comport420\DCU

     CPortSetup.dfm、CPortTrmSet.dfm、CPortImg.res 三个文件链接时即可被软件集成。

     或者在 Tool\Options\C++\Paths and Directories 界面，选择 Windows 64-bit / 32-bit Platform，
     在 Library path，添加以上文件的路径。

 4.  C++ Shared Options \_TCHAR maps to 选项
     设置为 char

 5.  64-bit程序中在链接时找不到 .a文件的问题处理
     添加C:\Users\Public\Documents\Embarcadero\Studio\23.0\Bpl\Win64\Release到工程，
     或者将.a文件复制到工程源程序目录。
    
 6.  TCustomComTerminal 控件问题  
     初步测试 TCustomComTerminal（自动接收缓冲）组件，不支持64-bit程序，但支持32-bit程序。

 7.  控件 ReadStr 函数修改
     delphi 控件 ReadStr 函数缺省参数 String 修改为 AnsiString，
     C++Builder 编码格式 _THAR 应设置为 char



 2025/07/11  wjandsq@163.com
 


